マルペイDocs

楽天ペイ（オンライン決済）V2随時とは

楽天ペイ（オンライン決済）V2随時とは、楽天ペイ（オンライン決済）における「汎用決済」です。お客様から事前に利用承諾を1度取得すると、加盟店様の任意のタイミングで決済（随時決済）を行うことができる決済方法です。
利用承諾が継続している間は、利用承諾時に発行された楽天サブスクリプションIDを指定することにより、お客様は決済操作せずに決済を行う事が可能です。
なお、利用承諾には、「利用承諾のみ」と、利用承諾と都度決済を同時に実行できる「利用承諾+都度決済」の２つのパターンがあります。

利用承諾のみ

処理フロー説明

1. 加盟店様サイトで申込開始（お客様→加盟店様）
2. 利用承諾申込処理（加盟店様→当サービス）
3. 利用承諾申込処理（当サービス→楽天）
4. 利用承諾申込情報発行（楽天→当サービス）
5. ユーザー誘導URL返却（当サービス→加盟店様）
6. 楽天ペイ決済ログイン画面表示（加盟店様→お客様）
7. 利用承諾処理（お客様→楽天）
8. 利用承諾完了通知（楽天→お客様）
9. 利用承諾完了通知（楽天→当サービス）
10. 利用承諾完了通知（当サービス→加盟店様）
    ※完了通知受信後必ず加盟店様にて「完了画面」を表示ください。

利用承諾+都度決済

処理フロー説明

1. 購入+利用承諾（お客様→加盟店様）
2. 決済申込+利用承諾申込処理（加盟店様→当サービス）
3. 決済申込+利用承諾申込処理（当サービス→楽天）
4. 決済申込結果+利用承諾申込結果の通知（楽天→当サービス）
5. ユーザー誘導URL返却（当サービス→加盟店様）
6. 楽天ペイ決済ログイン画面表示（加盟店様→お客様）
7. 決済+利用承諾処理（お客様→楽天）
8. 決済完了+利用承諾完了通知（楽天→お客様）
9. 決済完了+利用承諾完了通知（楽天→当サービス）
10. 決済完了+利用承諾完了通知（当サービス→加盟店様）
11. 商品/サービス提供
12. 入金（楽天→加盟店様）

随時決済

処理フロー説明

1. 決済処理（加盟店様→当サービス）
2. 決済処理（当サービス→楽天）
3. 決済結果返却（楽天→当サービス）
4. 決済完了通知（当サービス→加盟店様）
5. 決済完了通知（楽天→お客様）
6. サービス提供
7. 入金（楽天→加盟店様）

利用承諾状態

取引状態		説明
未決済	UNPROCESSED	利用承諾が完了していない状態（お客様のご注文途中の離脱が主な原因）
要求成功	REQSUCCESS	利用承諾を行う準備が整った状態（まだ利用承諾は完了していません）
認証処理中	AUTHPROCESS	楽天ペイでの認証中の状態
利用承諾	REGISTER	利用承諾が正常に完了した状態
決済失敗	PAYFAIL	お客様による利用承諾の中断や、システムトラブル等の何らかの原因でお支払いに失敗してしまった状態
期限切れ	EXPIRED	要求成功／認証処理中の状態を一定時間経過した状態

利用承諾の状態遷移

各操作を行った際の取引状態の遷移です。
「－」は、該当する結果、もしくは操作がないことを表しています。

操作	操作結果	操作前の状態	操作後の状態
取引登録	－	－	未決済
決済実行	成功	未決済	要求成功
	失敗		未決済
利用承諾手続き開始IFの呼び出し	－	要求成功	認証処理中
お客様が楽天で利用承諾	成功	認証処理中	利用承諾
	失敗		決済失敗
利用承諾が未完了で期限切れ	－	要求成功／認証処理中	期限切れ

利用承諾状態における可能操作

取引状態	取引登録	決済実行	支払手続き開始
未決済	-	〇	-
要求成功	-	-	〇
認証処理中	-	-	-
利用承諾	-	-	-
決済失敗	-	-	-
期限切れ	-	-	-

随時決済取引状態

取引状態		説明
未決済	UNPROCESSED	決済が完了していない状態（お客様のご注文途中の離脱が主な原因）
仮売上	AUTH	決済が正常に完了し、ご利用枠を確保した状態
実売上	SALES	売上が確定した状態
即時売上	CAPTURE	仮売上を行わず、売上を確定した状態
キャンセル	CANCEL	仮売上の取引がキャンセルされた状態
返金	RETURN	売上を確定した取引がキャンセルされた状態
決済失敗	PAYFAIL	お客様による支払い中断や、システムトラブル等の何らかの原因でお支払いに失敗してしまった状態
期限切れ	EXPIRED	要求成功の状態を一定時間経過した状態

随時決済取引状態遷移

各操作を行った際の取引状態の遷移です。
「－」は、該当する結果、もしくは操作がないことを表しています。

操作	操作結果	操作前の状態	操作後の状態
取引登録	－	－	未決済
決済実行	成功	未決済	仮売上／即時売上
	失敗		未決済
実売上	成功	仮売上	実売上
	失敗		仮売上
キャンセル	成功	仮売上／実売上／即時売上	キャンセル／返金
	失敗		操作前の状態
キャンセル（一部）	成功	実売上／即時売上 （仮売上には対応していません）	操作前の状態
	失敗		操作前の状態
金額変更	成功	仮売上／実売上／即時売上	仮売上／実売上／即時売上
	失敗
支払いが未完了で期限切れ	－	要求成功	期限切れ

随時決済取引状態における可能操作

取引状態	取引登録	決済実行	実売上	キャンセル	キャンセル（一部）
未決済	-	〇	-	-	-
要求成功	-	-	-	-	-
仮売上	-	-	○	○	-
実売上	-	-	-	○	○
即時売上	-	-	-	○	○
キャンセル	-	-	-	-	-
返金	-	-	-	-	-
決済失敗	-	-	-	-	-
期限切れ	-	-	-	-	-

接続方式別の対応状況

接続方式	対応状況
プロトコルタイプ	○
モジュールタイプ	○
リンクタイプPlus	-

注意事項

内容	説明
利用可能な決済金額	100～9,999,999円 利用金額+税送料の合計金額になります。 100円未満の決済が必要な場合は事前に楽天へお問い合わせください。
各処理期限	各処理の詳細期限はこちら
サブスクリプション利用金額について	利用金額+税送料とサブスクリプション利用金額は異なる金額を設定できます。 ただし、ユーザー様にとって決済金額が分かりづらくなるため、利用金額+税送料とサブスクリプション利用金額は同じ金額にすることを推奨します。また、変更となる場合は事前通知を推奨します。
仮売上有効期限延長	同額で金額変更のAPIを実行することで、仮売上有効期限を延長することができます。 再オーソリを行なうため、お客様の限度額を超えた場合は失敗する可能性があります。
仮売上有効期限延長可能回数	一つの取引に対し、成功・失敗合わせて15回まで。 可能回数を超えた場合は「RP1000006」エラーが返却されます。
金額変更	金額変更の回数に制限はありません。
期限切れ	状態が要求成功（REQSUCESS）または認証処理中（AUTHPROCESS）のまま処理期限が過ぎた取引については、毎日夜間に取引状態を期限切れ（EXPIRED）に更新します。
メール	以下の処理タイミングで楽天からお客様にメールが送信されます。 ・決済成功時 ・金額変更時（同額は含まない） ・キャンセル時
在庫キャンセル	決済後に在庫の引き当てが出来なかった場合は、速やかにキャンセルを実施してください。 （ユーザ様が期間限定ポイントを使用していた場合、トラブルに発展する可能性があるため。）
楽天表記審査・システムチェックについて	サービスリリース前に楽天レギュレーションの対応状況を確認する表記審査・システムチェックがございます。 実装前に楽天レギュレーションをご確認ください。 詳細は楽天ペイ営業担当へお問い合わせください。
支払いボタンについて	楽天ペイ選択後、楽天ログイン画面へ遷移させる遷移元画面に設置いただくボタンは楽天指定のソースである必要があります。 実装前に楽天レギュレーションをご確認ください。 詳細は楽天ペイ営業担当へお問い合わせください。
楽天ペイについて	「楽天ペイ（オンライン決済）V2」は従来の「楽天ペイ」とは別サービスになります。 本仕様書は「楽天ペイ（オンライン決済）V2」になります。 「楽天ペイ」をご利用の加盟店様は別ドキュメントになりますのでご契約をご確認ください。
随時決済契約について	随時決済は、都度決済とは別途楽天へ申込が必要になりますのでお問い合わせください。
楽天ペイ決済画面猶予期間について	誘導URLの返却から楽天ペイ決済画面にログインするまでに30分間の猶予期間があります。 楽天ペイ決済画面にログインしてからセッションが切れるまでに60分間の猶予期間があります。
楽天ポイント/キャッシュ分の返還について	キャンセル可能期限を過ぎた場合、楽天ポイント/キャッシュは返還されません(※2)。 お客様とのトラブル防止のため、各処理期限までに実売上処理、またはキャンセル/返品を実施してください。 既定の期限を超過し実売上処理、またはキャンセル/返品をともに行えなくなった場合、楽天ポイント/キャッシュについては加盟店様にてお客様へ直接返金を実施してください。
利用承諾終了について	お客様が楽天ペイアプリ上で解約操作を実施した場合、当サービスの取引状態は利用承諾のままとなります。

各処理期限

取引状態	実売上	キャンセル	金額変更	仮売上有効期限延長
仮売上	最後の仮売上日（※1）から30日後まで かつ初回の仮売上日から365日後（※2）まで	初回の仮売上日から365日後（※2）まで	初回の仮売上日から365日後（※2）まで かつ最後の仮売上日（※1）から30日後まで	初回の仮売上日から365日後（※2）まで かつ最後の仮売上日（※1）から160日後まで
実売上／即時売上	-	初回の仮売上日から365日後（※2）まで かつ実売上／即時売上日から30日後まで	初回の仮売上日から365日後（※2）まで かつ実売上日／即時売上日から30日後まで	-

※1 「最後の仮売上日」とは、仮売上、金額変更、仮売上有効期限延長の最終実施日を指します。
※2 対象取引の更新が無い場合は原則180日でデータが削除され、以降は処理ができなくなります。
  金額変更、仮売上有効期限延長により取引を更新した場合の最大日数が365日後となりますのでご注意ください。

ロゴについて

必ずロゴマーク利用ガイドラインをご確認の上ご利用ください。

ロゴ

ロゴはデザイン、カラーを変更せず十分な余白を用意し、そのままの状態で利用ください。

【大】300×88	https://checkout.rakuten.co.jp/rpay/logo/s_sb_30088.jpg
【中】200×59	https://checkout.rakuten.co.jp/rpay/logo/s_sb_20059.jpg
【小】100×30	https://checkout.rakuten.co.jp/rpay/logo/s_sb_10030.jpg
【大】140×127	https://checkout.rakuten.co.jp/rpay/logo/w_wb_140127.jpg
【中】100×91	https://checkout.rakuten.co.jp/rpay/logo/w_wb_10091.jpg
【小】60×55	https://checkout.rakuten.co.jp/rpay/logo/w_wb_6055.jpg

決済ボタン

楽天ペイの決済ボタンを動的に生成する場合、決済フローの楽天ペイ注文ボタン生成についてをご利用いただくようお願いします。